.TH INTLTOOL-MERGE 8 "2003-08-02" "intltool"

.SH NAME
intltool-merge \- merge translated strings into various types of file

.SH SYNOPSIS
.B "intltool-merge"
.I "[option]..." PO_DIRECTORY FILENAME OUTPUT_FILE


.SH DESCRIPTION
.PP
Merge translated strings in po files in \fIPO_DIRECTORY\fR with the original
application file \fIFILENAME\fR, and output the file \fIOUTPUT_FILE\fR
containing both original and localized strings.
.PP
If \fIFILENAME\fR is an XML file, \fIOUTPUT_FILE\fR will contain repeated
xml nodes, where each node contains one of the localized strings with
"xml:lang" attribute.


.SH OPTIONS
.\" -------------------------------------------------------
.SS "Mode of operation"
.\" -------------------------------------------------------
.IP "\fB\-b\fR" 4
.PD 0
.IP "\fB\-\-ba-style\fR" 4
.PD
Merge files in bonobo-activation style, which is used for bonobo servers.
.IP "\fB\-d\fR" 4
.PD 0
.IP "\fB\-\-desktop-style\fR" 4
.PD
Merge files in desktop style, which is similar to the Windows .ini file format.
.IP "\fB\-k\fR" 4
.PD 0
.IP "\fB\-\-keys-style\fR" 4
.PD
Merge files in keys style, which is used for metadata.
.IP "\fB\-o\fR" 4
.PD 0
.IP "\fB\-\-oaf-style\fR" 4
.PD
(OBSOLETE) Same as
.BR \-b / \-\-ba-style "."
.IP "\fB\-r\fR" 4
.PD 0
.IP "\fB\-\-rfc822deb-style\fR" 4
.PD
Merge files in RFC 822 style, which is usually used in Debian configuration files.
.IP "\fB\-\-quoted-style\fR" 4
.PD
Merge files in quoted string style, which just translates any strings within "".
.IP "\fB\-x\fR" 4
.PD 0
.IP "\fB\-\-xml-style\fR" 4
.PD
Merge files in standard XML style, both as attributes and as raw pcdata.

.\" -------------------------------------------------------
.SS "Other options"
.\" -------------------------------------------------------
.IP "\fB\-u\fR" 4
.PD 0
.IP "\fB\-\-utf8\fR" 4
.PD
Convert all strings to UTF-8 before merging.
.IP "\fB\-p\fR" 4
.PD 0
.IP "\fB\-\-pass-through\fR" 4
.PD
Use strings as is in .po files without conversion (STRONGLY unrecommended
with \-x).
.IP "\fB\-c\fR" 4
.PD 0
.IP "\fB\-\-cache\fR" 4
.PD
(TBD)
.IP "\fB\-q\fR" 4
.PD 0
.IP "\fB\-\-quiet\fR" 4
.PD
Be quiet while running.
.IP "\fB\-v\fR" 4
.PD 0
.IP "\fB\-\-version\fR" 4
.PD
Show version information.
.IP "\fB\-h\fR" 4
.PD 0
.IP "\fB\-\-help\fR" 4
.PD
Show usage and basic help information.


.SH FILES
.IP "\fBpo/.intltool-merge-cache\fR"
Cache file generated by \fBintltool-merge\fR, that contains all strings
in all po files separated by \\01.


.SH REPORTING BUGS
Report bugs to http://bugs.launchpad.net/intltool


.SH AUTHOR
Darin Adler <darin@bentspoon.com>
.br
Kenneth Christiansen <kenneth@gnu.org>
.br
Maciej Stachowiak <mjs@eazel.com>


.SH SEE ALSO
.BR iconv (1),
.BR intltoolize (8),
.BR intltool-prepare (8),
.BR intltool-extract (8),
.BR intltool-update (8)
